home *** CD-ROM | disk | FTP | other *** search
/ NeXT Education Software Sampler 1992 Fall / NeXT Education Software Sampler 1992 Fall.iso / Programming / Source / winterp-1.13 / doc / RUNNING < prev    next >
Encoding:
Text File  |  1991-10-06  |  4.5 KB  |  101 lines
  1. # 
  2. # WINTERP Copyright 1989, 1990, 1991 Hewlett-Packard Company (by Niels Mayer).
  3. # XLISP version 2.1, Copyright (c) 1989, by David Betz.
  4. #
  5. # Permission to use, copy, modify, distribute, and sell this software and its
  6. # documentation for any purpose is hereby granted without fee, provided that
  7. # the above copyright notice appear in all copies and that both that
  8. # copyright notice and this permission notice appear in supporting
  9. # documentation, and that the name of Hewlett-Packard, David Betz and
  10. # Niels Mayer not be used in advertising or publicity pertaining to distribution
  11. # of the software without specific, written prior permission.  Hewlett-Packard,
  12. # David Betz and Niels Mayer makes no representations about the suitability of
  13. # this software and documentation for any purpose.  It is provided "as is"
  14. # without express or implied warranty.
  15. #
  16.  
  17. RUNNING WINTERP:
  18. ================
  19.  
  20.     0) First, you should compile WINTERP. See ./COMPILING for details.
  21.  
  22.     1) Once WINTERP has been compiled, start up the 'winterp' program
  23.     in ./../src-server/winterp by running it in a terminal emulator
  24.     window (xterm, hpterm, gnu-emacs' M-X shell). WINTERP will create
  25.     windows and widgets when you ask it to, the results of evaluating 
  26.     Winterp-Lisp language expressions will print to "standard
  27.     output", and any XLISP, Motif, Xt, or X error messages will print
  28.     to "standard error".
  29.  
  30.     See ./winterp.doc for X resources that you may want to set before
  31.     starting up WINTERP. In particular, you should set resources
  32.     "Winterp.lispInitFile" and "Winterp.lispLibDir" according to the
  33.     directions given in the section of winterp.doc entitled
  34.     "WINTERP Resources (~/.Xdefaults)".
  35.  
  36.     2) make sure you've installed the winterp client program
  37.     './winterp/src-client/wl' somewhere on your search path ($PATH).
  38.  
  39.     See ./winterp.doc sections entitled "Usage: the WINTERP-Lisp Unix
  40.     Domain Socket client" for details on 'wl'.
  41.  
  42.     3) start up gnu-emacs. In gnu-emacs, load the emacs-lisp file
  43.     ./../src-client/winterp.el. (Use M-x load-file, or do
  44.     (load "<pathname>/winterp") in your ~/.emacs file)
  45.  
  46.     See ./winterp.doc sections entitled 
  47.     "Usage: the Gnu-Emacs programmers interface" for details.
  48.  
  49.     4) in gnuemacs, do find-file (^X^f) on one of the example programs
  50.     in ./../examples/*.lsp: a good start might be the simple search
  51.     browser    application built upon the unix 'grep' command --
  52.     ./../examples/grep-br.lsp'. See ./../examples/README for a 
  53.     description of the example code provided in the WINTERP
  54.     distribution.
  55.  
  56.     After visiting a *.lsp file, the buffer you're in should be in
  57.     'lisp'-mode. Place the point somewhere within a lisp s-expression
  58.     (aka, in between the opening and closing parentheses of a lisp
  59.     statement), and hit C-M-X to send the expression you're pointing at
  60.     to WINTERP. If you don't like hitting C-M-X, you can rebind the
  61.     gnuemacs function winterp-send-defun to    a more accessible key.
  62.     To send the current buffer being edited to WINTERP, you may use M-X
  63.     winterp-send-buffer
  64.  
  65.     5) browse around  the various files in ./../examples and evaluate
  66.     various forms.... The best way to see the power of combining Motif
  67.     widgets with XLISP is via programming by example.
  68.  
  69.             --------------------
  70.  
  71. If you don't use gnuemacs, you can still send lisp input to WINTERP,
  72. although it's much less elegant. While WINTERP is running inside a terminal
  73. emulator, just use the 'wl' command to send forms to the lisp interpreter.
  74. Assuming you either started WINTERP while cd'd to ./../examples, or
  75. assuming that you set resource "Winterp.lispLibDir" to the examples
  76. directory, you can then issue the following command to the shell
  77.         wl '(load "grep-br")'
  78. WINTERP will then load the file grep-br.lsp, and the grep search browser
  79. application will appear momentarily.
  80.  
  81.             --------------------
  82.  
  83. Another way for non-emacs users to program in Winterp-Lisp is by using the
  84. Winterp control panel, which is written in Winterp-Lisp. You should load
  85. file ./../examples/w_ctrlpnl.lsp from your WINTERP initialization file.
  86. For details on how to do that, see the section in winterp.doc that
  87. documents resource "Winterp.lispInitFile". Just to try things out, you can
  88. just load the control panel from the shell:
  89.         wl '(load "w_ctrlpnl")'
  90.  
  91. w_ctrlpnl.lsp will give you a simple file-browser (based on the Motif
  92. XmFileSelectionBox widget) that will allow you to load Winterp-Lisp files
  93. into WINTERP.  You may also edit files in an editor (based on the Motif
  94. XmText widget), and interactively send individual Winterp-Lisp expressions
  95. off for evaluation using the "Eval @ Point" button. See
  96. ./../examples/README and ./../examples/w_ctrlpnl.lsp for details.
  97.  
  98.             --------------------
  99.  
  100.  
  101.